home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -serious- / programming / basic / mildred / mildred.readme < prev    next >
Text File  |  2000-03-11  |  4KB  |  71 lines
  1. Short:    Chunkygraphics library v1.51 for Blitz Basic 2
  2. Author:   Paul West
  3. Uploader: paul@stationone.demon.co.uk
  4. Type:     dev/basic
  5. Replaces: Mildred.lha
  6. Requires: 68020+ CPU, preferably some fastram, and prior knowledge of blitz
  7.  
  8. NB: This archive is a replica of the entire contents of the Mildred website.
  9.  
  10. Mildred is a 2D chunkygraphics library for Blitz Basic 2. It attempts to replace
  11. most of the existing planar graphics system and also add new features and
  12. capabilities, the main difference being that everything is done in `chunky' data
  13. format rather than planar. This has many advantages in various areas and a
  14. comprehensive range of blit and other routines are provided as well as many
  15. custom objects (chunky bitmaps, shapes, queues, tables, c2pwindows, etc..)
  16.  
  17. Mildred brings you 219 new tokens, with the functionality of 407 via syntax
  18. variations and God knows how many variations of blit modes and switches, in a
  19. custom library which has full runtime errochecking routines. The library is the
  20. largest ever made for blitz but probably you will not mind the byte overhead
  21. when you consider what it will make possible for you in your software. Working
  22. in chunky allows easy graphics-card support and output to AGA via a flexible
  23. chunky-to-planar system.
  24.  
  25. The Mildred library was written in 1998-2000 by Paul West. Full copyright has
  26. been reclaimed from Pagan Games. You are permitted to use the lib in any and
  27. all of your blitz software, be it freeware, shareware, licenseware,
  28. commercialware or whatever. I do not ask for any fee in return unless you are
  29. feeling generous. If you are using it in an commercial product that is
  30. retailing for more than 5 UK-pounds per item, then I wouldn't mind a mention or
  31. some cash. :-D
  32.  
  33. The original aminet archive was a collection of archives from the official Mildred
  34. support site, which is at http://www.stationone.demon.co.uk and the same trend
  35. continues with this update. There have been a number of revisions since the
  36. previous update and some more example programs added. The full sourcecode to the
  37. library is also now available in ascii and BB2 format! Loading up index.html
  38. you will be greeted with a copy of the front page of the support site, which will
  39. allow you to read the comments about each of the archives to give you some idea
  40. of what they are. The main Mildred library is in the Mildred.lha archive. See the
  41. documentation for how to install it.
  42.  
  43. If you are on the internet I suggest you just go to the support site, and also
  44. recommend joining the blitz mailing list if you haven't already done so which
  45. can be achieved by sending an empty message to blitz-list-subscribe@netsoc.ucd.ie
  46. where you will find a number of blitz addicts and Mildred users.
  47.  
  48. The previous aminet release was v1.50.
  49.  
  50. This library is now v1.51. This may not be the last release as I still have
  51. ideas for future optimisations and tokens. The following changes to the library
  52. itself have occured since the release of v1.50:
  53.  
  54. v1.51 - Work resumed 27/02/2000 for the first time since 22/05/1999, copyright ownership has been reclaimed
  55.       - Bug identified in PerformBlit1/2/3_16[b] MSimpleReMapMode. Masking isn't working right, shape's cookie is blocks of 4!
  56.       - Macro RemakeStencil optimised by changing SNE.b to SEQ.b and removing the NOT.l, slight speedup making cookie/stencil
  57.       - Fixed bug in PerformBlit1/2/3_16[b] MSimpleReMapMode. Replaced TST.l with CMP.l #-1, as it was skipping 4 instead of 1
  58.       - Design flaw: Programmers should beware that cludged cookies/stencils must share the same linemodulo as the main data
  59.       - Optimised macro PerformYFlip for improved speed Yflipping if width is multiple of 16
  60.       - Optimised/recoded macro PerformXFlip for improved speed Xflipping if width is multiple of 4 or 16. ScrollDemo is 1fps+
  61.  
  62. Note that this release includes new example programs, the full library
  63. sourcecode, and a spruced up website.
  64.  
  65. Probs/comments/suggestions/worldly praise to paul@stationone.demon.co.uk
  66.  
  67. Also check out http://www.stationone.demon.co.uk for the support site.
  68.  
  69. Cheers,
  70. Paul.
  71.